home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 May: Tool Chest / Developer CD Series Tool Chest (Apple Computer)(May 1999).iso / Tool Chest / Development Kits / MPW etc / MPW-GM / MPW / Examples / SIOWExamples / Instructions < prev    next >
Encoding:
Text File  |  1998-12-03  |  3.3 KB  |  83 lines  |  [TEXT/MPS ]
  1. Instructions - The SIOW Example
  2.  
  3. Copyright Apple Computer, Inc. 1990, 1994
  4. All rights reserved.
  5.  
  6. About the Example
  7.  
  8.     SIOW (Simple Input/Output Window) is a package that enables a program
  9.     (C or Pascal), which does I/O in "glass teletype" fashion, to became a 
  10.     stand-alone application running in its own window.  The MPW 3.3 "Building
  11.     and Managing Programs in MPW" manual describes the behavior of such
  12.     applications in detail.  In brief, an input operation following a prompt
  13.     will read only the characters that were actually typed or selected.  That
  14.     is, the prompt is not read unless it is explicitly selected.  Most of the
  15.     items in the File, Edit, Font, and Size menus are available (not dimmed),
  16.     and operate as one would expect.
  17.     
  18.     The only example provided presently is a version of Count, derived from the
  19.     version to be found in CExamples.  The essential change is that the parameters:
  20.     whether a count of lines, characters, or both is desired, and the list of
  21.     files to be examined, are provided interactively at execution time.  In the
  22.     version in CExamples, this information is taken from the command line.
  23.     
  24. Building the Example
  25.  
  26.     Set the default directory to "SIOWExamples:"
  27.         
  28.         This can be done either by the command 
  29.         
  30.             Directory "{MPW}"Examples:SIOWExamples:
  31.             
  32.         or by
  33.         
  34.             SetDirectory "{MPW}"Examples:SIOWExamples:
  35.             
  36.     Building the program
  37.     
  38.         You can create a makefile (overriding the one already supplied)
  39.         by using the "Create Build Commands" item in the Build menu.
  40.         When doing this, select the radio button entitled "SIOW App.".
  41.         The application can then be built using any of the remaining 
  42.         items: Build, Full Build, Show Build Commands, Show Full Build
  43.         Commands.  The behavior of each of these is:
  44.         
  45.             Build…  -  The program is automatically built.  The commands
  46.             used, and any error messages, are displayed in the Worksheet.
  47.             Only files that have been changed since you last built the
  48.             program are compiled, saving considerable time.
  49.     
  50.             Full Build…  -  The program is completely rebuilt, ignoring
  51.             any object files or intermediate files that may already exist
  52.             from a previous build.  The commands used, and any errors, are
  53.             displayed in the Worksheet.
  54.             
  55.             Show Build Commands…  -  The commands needed to build the program
  56.             are written to the Worksheet, but not executed.  You can then
  57.             select any or all of the commands and execute them yourself.
  58.             (To execute the commands select them and press Enter.)
  59.             
  60.             Show Full Build Commands…  -  The commands needed to completely
  61.             rebuild the program are written to the Worksheet.  This is a
  62.             convenient way to see all of the commands used in building
  63.             the program you have selected.
  64.             
  65.         Alternatively, you can build the application by executing one of the 
  66.         following commands (this utilizes the supplied file Makefile):
  67.         
  68.             # this command line builds a "fat" app, consisting of both
  69.             # PowerPC and 68K executable instructions.
  70.             BuildProgram Count ∑∑ "{worksheet}"
  71.             
  72.             # this builds the native PowerPC version
  73.             BuildProgram Count.ppc ∑∑"{Worksheet}"
  74.             
  75.             # this builds the 68k version
  76.             BuildProgram Count.68k ∑∑"{Worksheet}"
  77.             
  78.     Launching the program
  79.     
  80.         Count can be launched from MPW as if it were a tool, or, alternatively,
  81.         it can be launched from the Finder in the same way as any other
  82.         application.
  83.